home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fgllinewidth.z / fgllinewidth
Encoding:
Text File  |  2001-04-17  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh - specify the width of rasterized lines
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh( REAL*4 _w_i_d_t_h )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _w_i_d_t_h  Specifies the width of rasterized lines.  The initial value is 1.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh specifies the rasterized width of both aliased and
  21.      antialiased lines.  Using a line width other than 1 has different
  22.      effects, depending on whether line antialiasing is enabled.  To enable
  23.      and disable line antialiasing, call ffffggggllllEEEEnnnnaaaabbbblllleeee and ffffggggllllDDDDiiiissssaaaabbbblllleeee with
  24.      argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSMMMMOOOOOOOOTTTTHHHH. Line antialiasing is initially disabled.
  25.  
  26.      If line antialiasing is disabled, the actual width is determined by
  27.      rounding the supplied width to the nearest integer.  (If the rounding
  28.      results in the value 0, it is as if the line width were 1.)  If
  29.      |Wx| _> |Wy|, _i pixels are filled in each column that is rasterized, where
  30.      _i is the rounded value of _w_i_d_t_h.  Otherwise, _i pixels are filled in each
  31.      row that is rasterized.
  32.  
  33.      If antialiasing is enabled, line rasterization produces a fragment for
  34.      each pixel square that intersects the region lying within the rectangle
  35.      having width equal to the current line width, length equal to the actual
  36.      length of the line, and centered on the mathematical line segment.  The
  37.      coverage value for each fragment is the window coordinate area of the
  38.      intersection of the rectangular region with the corresponding pixel
  39.      square.  This value is saved and used in the final rasterization step.
  40.  
  41.      Not all widths can be supported when line antialiasing is enabled. If an
  42.      unsupported width is requested, the nearest supported width is used.
  43.      Only width 1 is guaranteed to be supported; others depend on the
  44.      implementation.  Likewise, there is a range for aliased line widths as
  45.      well.  To query the range of supported widths and the size difference
  46.      between supported widths within the range, call ffffggggllllGGGGeeeetttt with arguments
  47.      GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE, GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE,
  48.      GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____GGGGRRRRAAAANNNNUUUULLLLAAAARRRRIIIITTTTYYYY.
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      The line width specified by ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh is always returned when
  52.      GGGGLLLL____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH is queried.  Clamping and rounding for aliased and
  53.      antialiased lines have no effect on the specified value.
  54.  
  55.      Nonantialiased line width may be clamped to an implementation-dependent
  56.      maximum.  Call ffffggggllllGGGGeeeetttt with GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE to determine the
  57.      maximum width.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh((((3333GGGG))))
  71.  
  72.  
  73.  
  74. EEEERRRRRRRROOOORRRRSSSS
  75.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than or equal to 0.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh is executed between the
  78.      execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  79.  
  80. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  81.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH
  82.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____AAAALLLLIIIIAAAASSSSEEEEDDDD____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE
  83.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____RRRRAAAANNNNGGGGEEEE
  84.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSMMMMOOOOOOOOTTTTHHHH____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH____GGGGRRRRAAAANNNNUUUULLLLAAAARRRRIIIITTTTYYYY
  85.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSMMMMOOOOOOOOTTTTHHHH
  86.  
  87.  
  88. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  89.      InfiniteReality systems do not support antialiased lines in color-index
  90.      rendering contexts.  (They are rendered as ordinary lines instead.)
  91.  
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      ffffggggllllBBBBlllleeeennnnddddFFFFuuuunnnncccc, ffffggggllllEEEEnnnnaaaabbbblllleeee, ffffggggllllHHHHiiiinnnntttt
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.